home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / OS2 / SFTP120.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1996-03-05  |  13.0 KB  |  259 lines

  1. Welcome to S-FTP version 1.20 (or simple FTP)!
  2. .
  3. The author of this software is Keith Cotroneo. I call S-FTP Week-End-Ware
  4. ....because I really only have time to work on it during the week ends.
  5. .
  6. I am a Dean at a college in Oregon. Computers are a hobby of mine and lately
  7. I have spent some time on the Internet. The FTP utilities that I have tried
  8. have not suited my needs very well and Web browser don't work well for batch
  9. downloads. So I wrote this program for my own use.
  10. .
  11. What I wanted was something that would allow me to:
  12. .
  13.         *logon the popular ftp sites without hassle
  14.         *read .txt information about files in the directories easily
  15.         *perform batch downloads
  16.         *do an occasional upload
  17. .
  18. S-FTP does those things for me.
  19. .
  20. If it works for you, you are welcome to use it with the following provisions:
  21. .
  22.         1) There is absolutely no warranty with this software. You use it
  23.         completely at your own risk. This means that you agree that if you
  24.         use the software and it somehow screws up your system or you lose files,
  25.         that is your problem, not mine.
  26.         2) You understand that this software was developed using the RXFTP
  27.         package and agree to the additional license arrangements listed in the
  28.         license.txt file. Also, thanks to Jeff Glatt for Filerexx!
  29.         3) You MUST register after 15 days of use of this product. To do so,
  30.         send me email or snail mail telling me your name, address, email
  31.         address, and then please provide comments on how I should improve the
  32.         product. I *do* use suggestions to make changes. I can be reached below:
  33. .
  34.                         cotroneo@mailman.tvcc.cc.or.us
  35.                               or
  36.                         Keith Cotroneo
  37.                         661 SW 5th St.
  38.                         Ontario, OR 97914
  39.         4) If you distribute the package to others, you must give them the whole
  40.         Zip file.
  41.         5) You may not sell this software product to anyone.
  42. .
  43. .
  44. Changes in S-FTP since version 1.00:
  45.         1) Text files in the Directory List are now loaded to the viewer by
  46.         single clicking on the file to highlight it and then clicking the view
  47.         push button.
  48.         2) The Download List may now be populated from a viewed text file. This
  49.         works for files such as the Hobbes 00index.txt files. For this function
  50.         to work, the filename must be in the first position in the line of the
  51.         text file.
  52.         3) While files are downloading, you can now continue to populate the
  53.         download list box. You can download files while you are viewing the
  54.         directory list or 00index.txt files in the viewer and continue to
  55.         transfer file names to the Download List. Files will be downloaded in
  56.         the order of transfer to the download list.
  57.         4) Lengthy processes, such as logon and downloading are now placed
  58.         in separate threads. This makes the application much more responsive
  59.         and doesn't lock the application while processes are completed.
  60.         5) Added download path setting and config menu option.
  61.         6) Added Delete Host and Add Host buttons to allow configuring the
  62.         host list.
  63.         7) Added several progress indicators to tell the user what is happening.
  64.         8) S-FTP will now download files from outside the current remote
  65.         directory. You can build the download list from various directories
  66.         or 00index.txt files. The download list will remember paths to those
  67.         files and retrieve them when you download.
  68.         9) Added capability to configure host user name, password, default
  69.         directory.
  70.         10) Improved the logon process. It is more streamlined and provides
  71.         better progress reporting.
  72. v1.05
  73.         11) Added upload capability.
  74. v1.06
  75.         12) Added capability to resize the main SFTP window.
  76.         13) Added audible beep to signify completion of download list.
  77.         14) Added date/time sort button for directory list.
  78.         15) Added auto date/time sorting check box for auto sorting
  79.         whenever the directory list is updated.
  80.         16) Added double click .txt files to viewer check box option.
  81.         17) Changed the directory list default font to system monospace.
  82.         *NOTE: all of the 1.06 changes were made at the request of users.
  83.                I have more and I am working on them.
  84. v1.07
  85.         18) Fixed the date sorting routine. It didn't work right. Now if
  86.         the Date Sort box is checked, the directory list will be downloaded
  87.         in descending date order.
  88. v1.08
  89.         19) Added back up directory button <<.
  90.         20) Increased directory text box character capacity.
  91. v1.09   21) Added capability to save window size and position.
  92. v1.09a  22) Fixed a compatibility problem with earlier versions and the
  93.         path.txt file. Users of previous versions can now keep their old
  94.         path.txt file, whereas v1.09 required replacing it.
  95. v1.10   23) Fixed a problem with the progress indicator not functioning on
  96.         FAT partitions. Thank you to Jeff Glatt for his wonderful FILEREXX
  97.         utilities. The FILEREXX.DLL is now required for SFTP.
  98. .
  99. To use S-FTP:
  100.         1) Unzip the S-FTP.ZIP file to the directory in which you want the
  101.         product to reside.
  102.         2) Copy the files rxftp.dll and filerexx.dll to a directory in your
  103.         DLL path.
  104.         3) Edit the hosts.txt file to include any hosts that you visit.
  105.         4) Create an object on the desktop if you want one.
  106.         5) Start your tcp client or internet connection.
  107.         6) Run S-Ftp by typing sftp at the command prompt or by clicking the object.
  108.         7) Click on the Config menu, choose Path, type in download path setting in
  109.         the textbox, click change button, double click upper left of window to
  110.         close.
  111.         8) Double click on the host name you wish to visit.
  112.         9) Click the logon button and wait for the connection. When connected,
  113.         the root directory listing will load into the directory list box.
  114.         10) Review limitations section at end of this help file.
  115. v1.20   24) Improved download progress indicator to provide percent
  116.         statistic.
  117.         25) Added download progress indicator for the viewer.
  118.         26) Added aliases, now you can have multiple aliases with different
  119.         download directories, user and password for each  host.
  120.         27) Changed behavior in the host listbox so that a double click
  121.         on the host alias automatically logs on the the remote host.
  122.         28) Added quick list type function to quickly add the current host
  123.         and directory to the alias list. Clicking on a Add Host now
  124.         automatically sets up the current directory with an alias in the
  125.         add host option window.
  126.         29) Added direct host logging. Typing a host with a directory, ie.
  127.         hobbes.nmsu.edu/incoming in the host edit box and then clicking on
  128.         logon will automatically logon to the host without having to set
  129.         up a specific host alias.
  130.         30) Changed the directory listbox behavior so that you can press
  131.         enter or  double click to select an entry.
  132.         31) Added the capability to press the escape key in the viewer to
  133.         close the viewer window.
  134.         32) Fixed the download routine so that it adjusts filenames to
  135.         conform to the 8.3 requirement when downloading to a FAT drive.
  136.         33) Made adjustments to the multi-threading components to
  137.         improve responsiveness.
  138. .
  139. To add new hosts and aliases:
  140.         1) Click Add Host.
  141.         2) A window pops up, complete the required information for the Host.
  142.         3) Click the Add Button to save the information.
  143.         4) Click Done to exit the window.
  144. .
  145. To quick add new hosts:
  146.         1) When you are in a directory of a remote host, click Add Host. The
  147.         Add Host window will automatically append the directory to the old
  148.         alias name to let you quickly set up the new host alias.
  149.         2) Click Add.
  150.         3) Click Done.
  151. .
  152. To change a host:
  153.         1) Click on Add Host.
  154.         2) Use the listbox to select the host alias (double click).
  155.         3) Change the information as needed.
  156.         4) Click Change and then Done.
  157. .
  158. To delete hosts:
  159.         1) Highlight the host alias in the Host listbox that you want to delete
  160.         by single clicking on it. Click the Delete Host button. The host is
  161.         removed from the listbox.
  162. .
  163. To logon to a remote host:
  164.         1) Double click on the alias in the host listbox.
  165. .
  166. To change a directory:
  167.         1) Double click on the directory in the directory listbox to which you
  168.         want to change (english, can you believe it?), or enter the directory
  169.         in the Directory textbox and click on the Dir Button.
  170. .
  171. To back up to a parent directory:
  172.         1) Click the << button.
  173. .
  174. To date/time sort a directory listing:
  175.         1) Click the Date Sort check box.
  176.         2) Now, when directory lists are downloaded, they will be sorted in
  177.         descending date order.
  178.         * This function was requested by users to make it easy to check an
  179.         /incoming directory and see the newest files first.
  180. .
  181. To download files:
  182.         1) Double click on the file(s) in the directory listbox that you
  183.         want to download.
  184.         2) Each file will be transfered to the download listbox.
  185.         3) When you are done choosing files, click on the download button
  186.         to begin receiving the files.They will be placed in the directory
  187.         specified by your path configuration in the config menu.
  188.         4) When the list is cleared, all your files have been transfered.
  189.         *Note: effective in version 1.02, you may continue to build the
  190.         download list while downloading is in progress. New files added to
  191.         the download list while downloading will be transfered in the
  192.         order appended to the download list.
  193.                                 or
  194.         If you are downloading from a site, such as Hobbes, that maintains
  195.         file listing descriptions in text files (ie. 00index.txt), you can
  196.         add files to the Download List from a viewed text file. To do so:
  197.         1) Highlight the text file (ie. 00index.txt) in the Directory List
  198.         by single clicking on it.
  199.         2) Click the View button to load the text file into the viewer.
  200.         3) Double click on the files in the viewer that you wish to transfer
  201.         to the Download list.
  202.         *Note: effective in version 1.02, you may continue to build the
  203.         download list while downloading is in progress. New files added to
  204.         the download list while downloading.
  205. .
  206. To delete files from the download list:
  207.         1) Double click on the files in the Download Listbox that you want to
  208.         remove.
  209.                         or
  210.         3) Click on the Clear List button to remove all files.
  211. .
  212. To view text files on a remote site:
  213.         1) Single click on a text file in the directory listbox to highlight the
  214.         file that you want to view.
  215.         2) Click the View push button.
  216.         *Note the view push button will only act on files in the directory list.
  217.         Files in the Download list are not affected.
  218.                         or
  219.         3) Click the .txt Dblclick check box.
  220.         4) With the .txt Dblclick check box selected, a double click on a file
  221.         in the directory list with a .txt extension will automatically load
  222.         the file to the viewer. This feature was requested by a user.
  223. .
  224. To upload a file:
  225.         1) Single click on the Upload menu.
  226.         2) Single click on either Ascii (if text file) or Binary (executable).
  227.         3) Choose the file from the file dialog. Click OK or double click on
  228.         the file.
  229.         4) In the next upload window, click Yes.
  230.         5) Wait for the upload to conclude. No file progress checking is shown.
  231.         6) If the upload is successful, the directory list will be downloaded.
  232. .
  233. To conduct simultaneous uploads, downloads, etc.:
  234.         1) Begin your first upload or download with SFTP.
  235.         2) Load a second copy of SFTP.
  236.         3) Initiate your second upload or download.
  237. .
  238. To save window size and position:
  239.         1) Click Config on the menu.
  240.         2) Click Save Size and Position.
  241. .
  242. Limitations:
  243.         1) One user reported difficulty downloading files from a direct network
  244.         connection. If you use this software directly of a network, instead of
  245.         through a modem, please let me know how it works for you off the
  246.         network.
  247.         2) Currently, SFTP is set up to handle Unix servers. Other server types
  248.         are not supported.
  249.         3) Still have not figured out how to kill the download thread without
  250.         closing the application. I believe there is a problem in the Vispro/rexx
  251.         that does not handle this aspect of multi-threading properly. If anyone
  252.         has suggestions please contact me.
  253. .
  254. Well, that is pretty much it. Let me know how things go.
  255. .
  256. Keith Cotroneo
  257. cotroneo@mailman.tvcc.cc.or.us
  258. Updated March 4, 1996
  259.